Boolean MyHRWasURLVisitedProc( const char *url, void *refCon);url - a pointer to a C-style string containing the URL.
refCon - an application defined value you provided when calling HRRegisterWasURLVisitedUPP to associate your visited proc with a HTML rendering object.
function result - an error code.
Your visited procedure will be called whenever the HTML rendering library would like to determine if a link has been visited. If you are maintaining your own database of visited links, you can use this routine to report visited links back to the HTML rendering library. If a link has been visited, your routine should return true. If not, then your routine should return false.
To set the visited links routine for a particular rendering object, call the HRRegisterWasURLVisitedUPP routine. The inRefCon parameter provided to this routine will be passed to your visited routine whenever it is called.
void HRRegisterWasURLVisitedUPP(
HRWasURLVisitedUPP inWasURLVisitedUPP,
HRReference hrRef,
void * inRefCon);
OSStatus MyHRNewURLProc( const char *url, const char *targetFrame, Boolean addToHistory, void *refCon);url - a pointer to a C-style string containing the URL.
targetFrame - a pointer to a C-style string containing the destination frame for the URL.
addToHistory - a boolean value.
refCon - an application defined value you provided when calling HRRegisterNewURLUPP to associate your visited proc with a HTML rendering object.
function result - an error code.
Your new url procedure will be called whenever the HTML rendering library replaces the HTML image being shown in the display. This routine provides an opportunity for your application to update the windows title and add the url to a history of visited links.
To set the new url routine for a particular rendering object, call the HRRegisterNewURLUPP routine. The inRefCon parameter provided to this routine will be passed to your new url routine whenever it is called.
void HRRegisterNewURLUPP(
HRNewURLUPP inNewURLUPP,
HRReference hrRef,
void *inRefCon);
OSStatus MyHRURLToFSSpecProc( const char *rootURL, const char *linkURL, FSSpec *fsspec, URLSourceType urlSourceType, void *refCon);rootURL - can be NULL. a pointer to a C-style string containing the root URL.
linkURL - can be NULL. a pointer to a C-style string containing the link URL.
fsspec - a pointer to a file system specification record where your routine should store the location of the file to be displayed.
urlSourceType - a value of type URLSourceType describing the type of file the HTML rendering library is looking for.
refCon - an application defined value you provided when calling HRRegisterURLToFSSpecUPP to associate your visited proc with a HTML rendering object.
Your new url procedure will be called whenever the HTML rendering library is trying to find a file associated with a particular link or URL. This routine provides an opportunity for your application to intercept URLs re-direct them to refer to different files on disk.
To set the url to FSSpec routine for a particular rendering object, call the HRRegisterURLToFSSpecUPP routine. The inRefCon parameter provided to this routine will be passed to your url to FSSpec routine whenever it is called.
void HRRegisterURLToFSSpecUPP(
HRURLToFSSpecUPP inURLToFSSpecUPP,
HRReference hrRef,
void *inRefCon);